Night Owl 6

home *** CD-ROM | disk | FTP | other *** search

/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 050a / cpcl.zip / PCX2PCL.DOC < prev next >

Wrap

Text File | 1991-08-29 | 27KB | 830 lines

████████▄ ▄█████▄ ▐██ ██▌ ▄████▄ ████████▄ ▄█████▄ ████ TM ██ █ ▐█▌ ██ ▀█▄ ▄█▀ ▐▀ ▐█▌ ██ █ ▐█▌ ██ ██ ███████▀ ██ ███ ▄██▀ ███████▀ ██ ██ ██ ▐█▌ ██ ▄█▀ ▀█▄ ▄█▀ ██ ▐█▌ ██ ██ ▄▄ ████ ▀█████▀ ▐██ ██▌ ███████▌ ████ ▀█████▀ ████████ PCX To PCL File Conversion & HP Macro Package (C) Copyright 1991 by TaxWare, PO Box 2014, Provo, UT 84603-2014 All rights reserved. ┌─────────┐ ┌─────┴───┐ │ (R) ──│ │o │────────────────── │ ┌─────┴╨──┐ │ Association of │ │ │─┘ Shareware └───│ o │ Professionals ──────│ ║ │──────────────────── └────╨────┘ MEMBER August 1991 Edition PCX2PCL v1.3 ───────────────────────────────────────────────────────── Copyright Notice PCX2PCL is Copyright 1991 by TaxWare and its author. All rights reserved. This document and all accompanying documentation is Copyright 1991 by TaxWare. All rights reserved. ───────────────────────────────────────────────────────── Trademarks PCX2PCL is a trademark of TaxWare and its author. All trademarks and registered trademarks referenced within this document are the property of their respective holders. ───────────────────────────────────────────────────────── Warranty Disclaimer TAXWARE MAKES NO WARRANTY OF ANY KIND, EXPRESSED OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE. TAXWARE DOES NOT ASSUME ANY LIABILITY FOR THE USE OF THIS SOFTWARE BEYOND THE ORIGINAL PURCHASE PRICE OF THIS SOFTWARE. IN NO EVENT WILL TAXWARE BE LIABLE TO YOU FOR ANY ADDITIONAL DAMAGES, INCLUDING ANY LOST PROFITS, LOST SAVINGS, OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING FROM THE USE OF, OR INABILITY TO USE, THIS SOFTWARE AND ITS ACCOMPANYING DOCUMENTATION, EVEN IF TAXWARE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. PCX2PCL User's Manual i PCX2PCL v1.3 Table of Contents ───────────────────────────────────────────────────────── Chapter One 1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Registered and Shareware Version Differences . . . . . . . . . . . 1 PCX2PCL System Requirements . . . . . . . . . . . . . . . . . . . . 1 PCX2PCL Installation . . . . . . . . . . . . . . . . . . . . . . . 2 Chapter Two 3 PCX2PCL Help . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 PCX2PCL Examples . . . . . . . . . . . . . . . . . . . . . . . . . 3 PCX2PCL Macro Usage . . . . . . . . . . . . . . . . . . . . . . . . 3 Chapter Three 5 PCX2PCL Applications . . . . . . . . . . . . . . . . . . . . . . . 5 DISPLAYWRITE 4 . . . . . . . . . . . . . . . . . . . . . . . . . . 5 MICROSOFT WORD 4 . . . . . . . . . . . . . . . . . . . . . . . . . 6 MICROSOFT WORD 5 . . . . . . . . . . . . . . . . . . . . . . . . . 6 MULTIMATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 OFFICE WRITER 5 . . . . . . . . . . . . . . . . . . . . . . . . . . 7 OFFICE WRITER 6 . . . . . . . . . . . . . . . . . . . . . . . . . . 7 PFS:WRITE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Q&A WORD PROCESSOR . . . . . . . . . . . . . . . . . . . . . . . . 7 SAMNA WORD IV . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 WORDPERFECT 5.0 . . . . . . . . . . . . . . . . . . . . . . . . . . 8 WORDPERFECT 5.1 . . . . . . . . . . . . . . . . . . . . . . . . . . 8 WORDSTAR 2000 . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 WORDSTAR 4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 WORDSTAR 5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 XYWRITE 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 DBASE, FOXBASE . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Appendix A 10 PCX2PCL Error Messages . . . . . . . . . . . . . . . . . . . . . . 10 Appendix B 10 Correspondence . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Index 11 ii PCX2PCL User's Manual PCX2PCL v1.3 Chapter One ───────────────────────────────────────────────────────── Introduction PCX2PCL is a utility used to convert ZSoft PCX format files to Hewlett- Packard PCL (Printer Command Language) format. PCX2PCL successfully converts images created with PC Paintbrush, Corel Draw, Scanning Gallery (with Hewlett-Packard's ScanJet scanner) and other software that can save images in PCX format. Converted files can be downloaded to and printed on HP LaserJet Plus, Series II, III and 100% compatible laser printers as graphic macros. Until August 26, 1991, a companion utility, TIF2PCL, was included in the package. It has been omitted due to the dynamic nature of the TIFF "standard." So, wherever you see the name PCX2PCL/TIF2PCL - it is really now just PCX2PCL. New with PCX2PCL version 1.1 are options to rotate images to landscape orientation (rotates images 90 degrees counter-clockwise), and to create negatives (reverses the black and white). New with PCX2PCL version 1.2 is the option to increase the size of the PCL image by a factor of 2, 3, or 4. If you specify /X2, for example, the PCL image created will be 2 times taller and 2 times wider than the original. Its resolution will also be cut in half. PCX2PCL version 1.3 corrects a very minor problem that would occur if the destination you specified for the converted PCL file was a different drive than where the PCX file was. The result was that only the portrait version of the graphic would be converted, and the message "Not Completed" would be displayed. This only occurred when using the /L or /N option. Also, PCX2PCL v1.3 is the first version released as ASP shareware. ───────────────────────────────────────────────────────── Registered and Shareware Version Differences PCX2PCL is distributed as both a shareware product and as a retail product. The shareware version and the retail version are identical, except that the shareware version displays reminders to order a registered copy of PCX2PCL, and it allows you to print the Order Form. If you are using the retail version, purchased from TaxWare, Thank You. If you are using the shareware version, we hope you find it to be useful. This manual is used with both the shareware and registered versions of PCX2PCL. If you are using the shareware version, refer to the following documents for additional information: SHAREW.DOC, REGISTER.DOC, ORDER.FRM. ───────────────────────────────────────────────────────── PCX2PCL System Requirements PCX2PCL requires the following: o A personal computer (PC) running DOS version 2.1 or higher and having at least 40K of free RAM PCX2PCL User's Manual 1 PCX2PCL v1.3 o An HP LaserJet or 100% compatible printer ───────────────────────────────────────────────────────── PCX2PCL Installation Installing PCX2PCL is very simple: o Create a subdirectory for PCX2PCL o Copy the files from the PCX2PCL distribution diskette to the new subdirectory For example, Create a subdirectory called PCX2PCL and change directory to it: C:> MD PCX2PCL C:> CD PCX2PCL Next, place the PCX2PCL distribution diskette in the floppy drive and copy all its files to the newly created subdirectory: C:> COPY A:*.* 2 PCX2PCL User's Manual PCX2PCL v1.3 Chapter Two ───────────────────────────────────────────────────────── PCX2PCL Help Type PCX2PCL at the DOS prompt to receive Usage help. A screen similar to the following will appear: Z:PCX2P Version 1.3 (reg'd to ?????) (C) Copyright TaxWare 1989, 1990. All Rights Reserved. Z:PCX2P - PCX To PCL File Conversion Utility Usage: Z:PCX2P [options] PCXFile[.PCX] [PCLFile[.PCL]] The following options are available: /L rotate to landscape orientation. /N create negative of the original. /Xn increase image n times (n = 2, 3, or 4). PCXFile is the file name of a PCX format file to be converted. PCLFile (optional) is the file name of the PCL file created. ───────────────────────────────────────────────────────── PCX2PCL Examples The following example converts the file SIGNATUR.PCX (PCX format) to the file SIGNATUR.PCL (PCL format). >PCX2PCL SIGNATUR.PCX SIGNATUR.PCL The following commands do the same as the above example: >PCX2PCL SIGNATUR.PCX >PCX2PCL SIGNATUR The following example converts the file MYLOGO.PCX (PCX format) to the file MYLOGO.PCL (PCL format). >PCX2PCL MYLOGO.PCX MYLOGO.PCL The following commands do the same as the above example: >PCX2PCL MYLOGO.PCX >PCX2PCL MYLOGO ───────────────────────────────────────────────────────── PCX2PCL Macro Usage The converted PCL files can now be used as graphic macros. In order to use graphic macros, they must be sent (downloaded) to your printer's memory. This can be accomplished by using the DOWNLOAD utility included with the package (see accompanying instructions). Once DOWNLOADed to the printer's memory, you must access a macro from within your word PCX2PCL User's Manual 3 PCX2PCL v1.3 processor or other application by inserting special printer commands called escape sequences. The method for inserting the escape sequences and for accessing a macro will differ, depending upon your application, and it is possible that more than one method will work. For best results, follow the steps outlined below: 1 Create a PCX file with a scanner or paint or draw program. 2 Convert the PCX file to PCL format. 3 Download the converted file as a macro using the DOWNLOAD utility 4 Follow the instructions below for your particular application. 5 Unload the macro from the printer's memory with the UNLOAD utility. Example Macro Usage For this example we will assume that you wish to have your signature printed at end of a letter. We will also assume that your current directory is where your Scanning Gallery software resides (call it C:\SCAN), and the PCX2PCL program disk is in your A: drive. 1 Sign your name on white paper using a dark ink. Scan the signature and save it as SIGNATUR.PCX. (Remember to select only the area of the paper that contains your signature - see Scanning Gallery User's Guide pg 40.) 2 Convert the image from PCX to PCL format. This example creates the PCL file SIGNATUR.PCL. C>A:PCX2PCL SIGNATUR.PCX (You will see a message indicating that the conversion is taking place.) 3 Download the converted file. This example downloads the macro with an ID of 1 to printer LPT1, the default printer. C>A:DOWNLOAD SIGNATUR.PCL /M1 (You will see a message indicating that the macro is being downloaded.) 4 Follow the instructions below for accessing the macro with your particular application. 5 Unload the macro from the printer's memory. Because the macro was DOWNLOADed with an ID of 1, it must be UNLOADed using the same ID. C>A:UNLOAD /M1 (You will see a message stating that the macro is unloaded.) 4 PCX2PCL User's Manual PCX2PCL v1.3 Chapter Three ───────────────────────────────────────────────────────── PCX2PCL Applications Below you will find brief instructions for accessing your PCL graphic macros from various applications. If your application prints to an HP LaserJet Plus, Series II, Series III or 100% compatible and instructions are not found here, please consult your documentation for how to insert printer commands/escape sequences. DISPLAYWRITE 4 ENVELOPER (See ENVELOPER Documentation) GRAB PLUS (See GRAB Documentation) MICROSOFT WORD 4 MICROSOFT WORD 5 MULTIMATE OFFICE WRITER 5 OFFICE WRITER 6 PFS:WRITE Q&A WORD PROCESSOR SAMNA WORD IV WinGrab (See GRAB Documentation) WORDPERFECT 4.2 WORDPERFECT 5.0 WORDPERFECT 5.1 WORDSTAR 2000 WORDSTAR 4 WORDSTAR 5 XYWRITE 3 DBASE, FOXBASE ───────────────────────────────────────────────────────── DISPLAYWRITE 4 Accessing macros with DisplayWrite 4 requires modification of your Printer Function Table. If you are using a PFT supplied by IBM, the PFT may be too large to edit. If you are using a PFT created by yourself or provided by HP, you should be OK. Create a User Defined Code for each graphic macro you wish to use. Start at the DisplayWrite 4 Main Menu: 9 profiles 6 revise table ENTER next screen filename.PFT name of the LaserJet printer function table 6 User-Defined Controls # enter a number from 1-999 for the control number (macro ID) to be used. For our example, we selected a macro ID of 1. Enter the escape sequence in hexadecimal representation: 1B 26 66 73 ## 79 33 78 31 53 to print the signature (replacing ## PCX2PCL User's Manual 5 PCX2PCL v1.3 with the hex equivalent of the control number; 31 in our case) ENTER to save the control code ESC exit from control code menu ESC exit from Revise Table ENTER end and save table ESC return to Main Menu To use the graphic macro within your document, place the cursor where you would want the image to appear. Then, F8 instructions 5 User-Defined Controls # the number of the control code (macro ID) you wish to use (1 with our example). ───────────────────────────────────────────────────────── MICROSOFT WORD 4 MICROSOFT WORD 5 At the location where the image is to appear, enter the escape character. To do this, hold down the ALT and enter 027 at the numeric keypad. Release the ALT key and enter the rest of the escape sequence without any spaces. ALT-027 &fs#y3x1S (replacing # with the macro ID) ───────────────────────────────────────────────────────── MULTIMATE At the location where the image is to appear, enter the escape sequence by entering each character at the numeric keypad. Each character must be preceded by an ALT-A. The decimal equivalent of the escape sequence is: 027 038 102 115 ### 121 051 120 049 083 (replacing ### with 049 in our case) To use the graphic macro within you document, enter the following: ALT-A while pressing the ALT key, press the A, release the ALT key ALT-027 while pressing the ALT key, enter 027 from the numeric keypad, release the ALT key ALT-A while pressing the ALT key, press the A, release the ALT key ALT-038 while pressing the ALT key, enter 038 from the numeric keypad, release the ALT key ALT-A while pressing the ALT key, press the A, release the ALT key ALT-102 while pressing the ALT key, enter 102 from the numeric keypad, release the ALT key (and so on) . . . 6 PCX2PCL User's Manual PCX2PCL v1.3 ───────────────────────────────────────────────────────── OFFICE WRITER 5 OFFICE WRITER 6 OfficeWriter allows the definition of special characters or codes to be sent to the printer which are then accessed similar to a macro. To enter the printer commands, start from the Main Menu: F5 Special Functions F3 Special Symbols Choose the CTRL + key combination you want to assign the macro. For our example we will arbitrarily use CTRL-S. You must enter the escape sequence using the decimal equivalents of the individual characters. The first character is the decimal equivalent of the character that will display on the screen. Enter the escape sequence as follows: CTRL-S 242 27 38 102 115 # 121 51 120 49 83 (replacing # with 49 in our case) To use the graphic macro within you document, simply insert the CTRL + key combination (CTRL-S in our case). ───────────────────────────────────────────────────────── PFS:WRITE Q&A WORD PROCESSOR At the location where the image is to appear, enter the escape sequence by entering each character as numeric digits in the following format: The decimal equivalent of the escape sequence is: *p 27,38,102,115,#,121,51,120,49,83* ───────────────────────────────────────────────────────── SAMNA WORD IV Samna Word IV uses the MARK function to provide insertion of printer control codes within a document. Enter the hexadecimal values of each of the characters on the escape sequence. At the location where the image is to appear, Press MARK Press E Press ENTER Enter the following escape sequence (without spaces, though): 1B 26 66 73 ## 79 33 78 31 53 to print the signature (replacing ## with the hex equivalent of the control number; 31 in our case) PCX2PCL User's Manual 7 PCX2PCL v1.3 ───────────────────────────────────────────────────────── WORDPERFECT 4.2 At the location where the image is to appear, enter a single space, then CTRL-F8 print format menu A enter printer control codes <27>&fs#y3x1S print the graphic macro (replace # with 1 in our case) F7 exit back to document ───────────────────────────────────────────────────────── WORDPERFECT 5.0 WORDPERFECT 5.1 At the location where the image is to appear, enter a single space, then SHIFT-F8 format menu 4 other formats 6 printer functions 2 printer commands 1 enter a command <27>&fs#y3x1S print the graphic macro (replace # with 1 in our case) F7 exit back to document ───────────────────────────────────────────────────────── WORDSTAR 2000 WordStar 2000 uses the PRINT EXTRA function to provide insertion of printer control codes within a document. To enter the printer commands, choose PRINT EXTRA at the printer install menu. Then enter the escape sequence: ^[&fs#y3x1S And assign a name to the PRINT EXTRA command. To print the image from within your document, enter CTRL-P X to invoke the PRINT EXTRA feature. Select the item you want to include and press Enter. ───────────────────────────────────────────────────────── WORDSTAR 4 WORDSTAR 5 WordStar uses the CTRL-P Q, CTRL-P W, CTRL-P E and CTRL-P R commands to provide custom print commands. To define these codes, enter the following in your document prior to using one of the commands. .XQ 1B 26 66 73 ## 79 33 78 31 53 to print the signature (replacing ## with the hex equivalent of the control number; 31 in our case) 8 PCX2PCL User's Manual PCX2PCL v1.3 At the location where the image is to appear, simply insert a CTRL-P Q to print the graphic macro. ───────────────────────────────────────────────────────── XYWRITE 3 XyWrite uses the Print Insert Command on the command line to provide custom print commands. At the location where the image is to appear, enter the following on the command line: PI <ESC>&fs#y3x1S (replacing the # with the macro ID) ───────────────────────────────────────────────────────── DBASE, FOXBASE To access and print a graphic macro from within dBase, simply "print" the escape sequence. For example, if you are formatting a report with the "@ xx,yy SAY" statement, you would enter the following: @ xx,yy SAY CHR(27)+"&fs#y3x1S" (replacing the # with the macro ID) PCX2PCL User's Manual 9 PCX2PCL v1.3 Appendix A ───────────────────────────────────────────────────────── PCX2PCL Error Messages The messages that you may encounter when running PCX2PCL are listed below with the reason(s) for the message. Error # These errors can only happen when rotating (see /L option ) or reversing (see /N option) the image. These errors should never occur. Please report these errors, along with the number, to TaxWare. File Names Cannot Be The Same The PCX and PCL filenames cannot be the same Insufficient Memory The program requires more memory to run. Unload memory resident software. Not A Valid PCX File The file is not a valid PCX file Unable To Open PCX File (filename) The file does not exist, or you do not have rights sufficient to open it. Appendix B ───────────────────────────────────────────────────────── Correspondence TaxWare is customer-driven. The evolution of our products is directly attributable to your feedback and intuitive suggestions. We can continue to serve you best when you let us know what you like and what you dislike about our products and services. Please talk to us. Reports of perceived bugs and requests for enhancements are also encouraged. Direct all communications to: TaxWare attn: PCX2PCL PO Box 2014 Provo, UT 84603-2014 Phone: (801) 373-0541 (Monday thru Friday, 10am-7pm MDT) 10 PCX2PCL User's Manual PCX2PCL v1.3 ───────────────────────────────────────────────────────── Index Appendix A . . . . . . . . . . . 10 Appendix B . . . . . . . . . . . 10 Applications . . . . . . . . . . . 5 Chapter One . . . . . . . . . . . 1 Chapter Three . . . . . . . . . . 5 Chapter Two . . . . . . . . . . . 3 Copyright Notice . . . . . . . . . i Correspondence . . . . . . . . . 10 DBASE . . . . . . . . . . . . . . 9 DISPLAYWRITE 4 . . . . . . . . . . 5 DOWNLOAD . . . . . . . . . . . 3, 4 Error Messages . . . . . . . . . 10 Examples . . . . . . . . . . . . . 3 FOXBASE . . . . . . . . . . . . . 9 Help . . . . . . . . . . . . . . . 3 Installation . . . . . . . . . . . 2 Introduction . . . . . . . . . . . 1 Macro Usage . . . . . . . . . . . 3 MICROSOFT WORD 4 . . . . . . . . . 6 MICROSOFT WORD 5 . . . . . . . . . 6 MULTIMATE . . . . . . . . . . . . 6 OFFICE WRITER 5 . . . . . . . . . 7 OFFICE WRITER 6 . . . . . . . . . 7 PFS:WRITE . . . . . . . . . . . . 7 Q&A WORD PROCESSOR . . . . . . . . 7 Registered and Shareware Version Differences . . 1 SAMNA WORD IV . . . . . . . . . . 7 System Requirements . . . . . . . 1 Table of Contents . . . . . . . ii TaxWare . . . . . . . . . . . . 10 Trademarks . . . . . . . . . . . . i UNLOAD . . . . . . . . . . . . . . 4 Warranty Disclaimer . . . . . . . i WORDPERFECT 5.0 . . . . . . . . . 8 WORDPERFECT 5.1 . . . . . . . . . 8 WORDSTAR 2000 . . . . . . . . . . 8 WORDSTAR 4 . . . . . . . . . . . . 8 WORDSTAR 5 . . . . . . . . . . . . 8 XYWRITE 3 . . . . . . . . . . . . 9 PCX2PCL User's Manual 11